home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Taifun / Taifun 197 (1992-03-10)(Manewaldt, A.)(DE)(PD).zip / Taifun 197 (1992-03-10)(Manewaldt, A.)(DE)(PD).adf / DRAFU / DRAFU.doc < prev    next >
Text File  |  1992-02-29  |  17KB  |  343 lines
  1. ==============================================================================
  2. ==============================================================================
  3. ===              DRAFU ("Draw A Function") V2.02c rel. 2010-91             ===
  4. ==============================================================================
  5. ===                          ( S H A R E W A R E )                         ===
  6. ==============================================================================
  7. ===              (benoetigt V34.01 oder hoeher der "ak_gen0.library"       ===
  8. ===                und greift auf die Mathematik-Libraries der             ===
  9. ===                Workbench V1.3 oder hoeher zu.)                         ===
  10. ==============================================================================
  11. ===                                                                        ===
  12. ===                       (c) 1990-91 by Andreas Ralph Kleinert            ===
  13. ===                                      Grube Hohe Grethe 23              ===
  14. ===                                      W-5900 Siegen 1                   ===
  15. ===                                      Germany                           ===
  16. ===                                                                        ===
  17. ==============================================================================
  18. ==============================================================================
  19.  
  20.      "DRAFU" ist (C)opyright 1990-91 by Andreas R. Kleinert und darf frei
  21.      kopiert werden. Eine "Entrichtung" des SHARE-Betrages ist erwuenscht,
  22.      aber nicht Zwang. Eine eventuell verlangte Kopiergebuehr pro Diskette
  23.      sollte 10 DM bzw. das 5-fache des Leerdiskettenpreises nicht uebersteigen.
  24.      (Der fuer fruehere Versionen von "DRAFU" geltende Betrag von 20 DM bzw.
  25.      15 DM gilt mit Erscheinen dieser Version NICHT mehr). ERWUENSCHT ist
  26.      allerdings ein Betrag, der, bis auf eine geringe Kopiergebuehr, in etwa
  27.      dem Preis einer Leerdiskette entspricht.
  28.      "DRAFU" darf nicht unvollstaendig weitergegeben werden !
  29.      Bestandteile von "DRAFU V2.02c" sind :
  30.  
  31.       - diese Anleitung
  32.       - die "ak_gen0.library" und ihre Anleitung
  33.       - der restliche Inhalt dieses Directories, soweit als Bestandteil
  34.         von "DRAFU" gekennzeichnet
  35.  
  36.      ----- Dokumentationsfile-Version : V2.02c-A-2010-91 -----
  37.  
  38. =============================================================================
  39. = PROGRAMMBESCHREIBUNG :                                                    =
  40. =============================================================================
  41.  
  42.    DRAFU steht fuer (D)raw (A) (Fu)nction, was soviel bedeutet wie
  43.    "Zeichne eine Funktion". Wie Sie gleich sehen werden, trifft
  44.    dieser Name in Bezug auf die Beschreibung der Funktionen des
  45.    Programmes genau ins Schwarze : DRAFU V2.02c ist naemlich in der Lage
  46.    saemtliche mathematischen Grundfunktionsarten wie lineare Funk-
  47.    tionen, quadratische Funktionen und Polynome grafisch darzustellen.
  48.  
  49. =============================================================================
  50. = HINWEIS :                                                                 =
  51. =============================================================================
  52.  
  53.      DIESES PROGRAMM IST SHAREWARE !!!
  54.    
  55.    - Was bedeutet dies konkret ?
  56.  
  57.      Wenn Sie dieses Programm regelmaessig benutzen, entrichten Sie bitte
  58.      einen SHARE-Betrag von DM 15 an mich. Dies ist jedoch FREIWILLIG
  59.      (deshalb ist dieses Programm keine KOMMERZIELLE Shareware) !!!
  60.      Haben Sie den SHARE-Betrag an mich entrichtet, so koennen Sie von
  61.      mir gegen Leerdiskette und Rueckporto (RP) jeweils die neueste Version
  62.      dieses Programmes in regelmaessigen Abstaenden (also ca. >= 2-3 Mon.)
  63.      erhalten.
  64.  
  65.      Dieses Angebot gilt solange, bis ich mich, aus welchen Gruenden auch im-
  66.      mer, nicht mehr in der Lage sehe, es zu diesen vergleichsweise gross-
  67.      zuegigen Bedingungen zu erfuellen (s.u.).
  68.  
  69.  
  70.    - Was geschieht, wenn dieses Angebot einmal NICHT mehr gelten
  71.      sollte (s.o.) ?
  72.  
  73.      Alternativen :
  74.  
  75.      a) Es faende keine Weiterentwicklung mehr statt.
  76.         (Unwahrscheinlich aber moeglich.)
  77.  
  78.       oder :
  79.  
  80.      b) Dieses Programm koennte in einer spaeteren Version als kommerzielle
  81.         Shareware vertrieben werden, eventuell mit Rabatt fuer diejenigen,
  82.         die bereits den freiwilligen Sharebetrag bezahlt haben.
  83.  
  84.       oder :
  85.  
  86.      c) Dieses Programm koennte in einer spaeteren Version komplett kommer-
  87.         ziell vertrieben werden.
  88.  
  89.      Fazit :
  90.  
  91.      Wuerde mir jemand, nachdem dieses Angebot bereits NICHT mehr gilt, noch
  92.      15 DM + RP + Leerdiskette zusenden, so wuerde ich den dazu notwendigen
  93.      Teil des RP dazu verwenden, um die 15 DM sowie die Diskette (leer) und
  94.      den Rest des RP zurueckzusenden, und ausserdem eine Information beilegen,
  95.      die Auskunft darueber gibt, welchen Status (a,b,c,?) die neue Version
  96.      des Programmes nun besizt und warum.
  97.      Selbstverstaendlich erhielten dann auch alle diejenigen, die bereits den
  98.      SHARE-Betrag bezahlt haben und mir eine Diskette mit RP schickten, um
  99.      ein Update zu bekommen, die Diskette und den Rest des RP zurueck, aller-
  100.      dings eventuell noch zusaetzlich mit einem Vorzugsangebot fuer die neue
  101.      Version (s.o.).
  102.  
  103.      Dies ist jedoch momentan alles (noch) nicht in greifbarer Naehe. Auch
  104.      glaube ich nicht, dass dieses Programm bereits ausgereift genug waere,
  105.      um auf dem kommerziellen (Shareware-)Markt Bestand haben zu koennen.
  106.  
  107.      Es lohnt sich also, einmal darueber nachzudenken, die (freiwillige)
  108.      SHAREWARE-Idee zu foerdern, zumal niemand ein Risiko eingeht (schon gar
  109.      nicht bei 15 DM) !
  110.  
  111.    - Notwendige Infomationen fuer mich :
  112.  
  113.      Geben Sie bitte immer auf jeden Fall die Version dieses Programmes an,
  114.      die Sie besitzen, so dass ich sehe, ob ein "Update" schon (oder noch)
  115.      moeglich bzw. sinnvoll ist.
  116.      Vergessen Sie bitte auch nicht, fuer alle Faelle Ihre Telefonnummer an-
  117.      zugeben !!!
  118.  
  119. =============================================================================
  120. = INSTALLATION :                                                            =
  121. =============================================================================
  122.  
  123.     Kopieren Sie die beigefuegte (oder eine hoehere) Version der
  124.     "ak_gen0.library" in das "LIBS:"-Verzeichnis (normalerweise "SYS:libs").
  125.  
  126. =============================================================================
  127. = BEDIENUNG (in groben Schritten) :                                         =
  128. =============================================================================
  129.  
  130.    Zunaechst waehlen Sie im Menue "Funktionen" den Menuepunkt an, der die Ka-
  131.    tegorie von Funktion vertritt, die Sie darstellen wollen (linear, quadra-
  132.    tisch, etc.). Teilweise gibt es mehrere Moeglichkeiten, eine Funktion ein-
  133.    zugeben : So laesst sich z.B. eine quadratische Funktion durch ihre Schei-
  134.    telpunktsform, durch ihre p-q-Form oder aber als Polynom fuenften  Grades,
  135.    bei der die Koeffizenten a5, a4 und a3 gleich Null sind, beschreiben.
  136.    Normalerweise ist nur eine dieser "Leerformeln" auch wirklich sinn-
  137.    voll, denn die Ausgabe aendert sich durch die Verwendung einer
  138.    etwas komplizierteren "Leerformel" natuerlich nicht, da die zusaetz-
  139.    lich einzugebenden Werte den Funktionsterm zwar ausserlich veraendern, aber
  140.    sich auf das Ergebnis in keinem Fall veraendernd auswirken.
  141.    
  142.    Nach Auswahl der "Leerformel" geben Sie die von der "Leerformel" be-
  143.    noetigten Werte ein, die diese zu einem gueltigen Funktionsterm werden
  144.    lassen.
  145.    Das sind in erster Linie die Variablen der "Leerformel" und zusaetzlich
  146.    folgende Angaben :
  147.                       - die Anzahl der "Schritte"
  148.                         (= Anzahl der Funktionswerte)
  149.                       - die Abstaende der zu verwendenden X-Werte
  150.                         (= Schrittweite)
  151.                       - der X-Wert, mit dem begonnen werden soll
  152.                         (z.B. Start mit x = -10).
  153.  
  154.    Danach beginnt die Darstellung der Funktion.
  155.    (PAL 640/256-Window auf PAL 640/256 HIRES-Screen mit 16 Farben).
  156.  
  157.    Die zuletzt dargestellte Funktion bleibt solange stehen, bis Sie eine
  158.    neue Funktion anzeigen lassen, die Farbeinstellung veraendern oder
  159.    andere Menues, die Ausgaben vornehmen, anwaehlen.
  160.  
  161.    Falls eine von Ihnen gewaehlte Funktion, trotz Korrektheit des Funktions-
  162.    term nicht dargestellt wird, versuchen Sie es bitte noch einmal, in-
  163.    dem Sie die Voreinstellungen im dazugehoerigen Menue aendern.
  164.    Sie koennen die Y-Achse und die X-Achse beliebig und und unabhaengig von-
  165.    einander verschieben und ausserdem die Groessen einer X- bzw. Y-"Einheit"
  166.    beliebig veraendern.
  167.    Mindestgroesse ist jedoch 1 Pixel fuer X bzw. Y (nicht empfehlenswert).
  168.  
  169.    Diese und andere Veraenderungen sind leicht einzustellen. Falls Sie
  170.    dennoch nicht ganz zurecht kommen sollten, koennen Sie als "autorisierter"
  171.    User von mir allerdings noch eine genauere Beschreibung der Funktionen
  172.    von DRAFU bekommen.
  173.  
  174. =============================================================================
  175. = BEISPIEL(E) :                                                             =
  176. =============================================================================
  177.  
  178.     Zum Schluss noch ein Anwendungsbeispiel : 
  179.  
  180.        1. Anwahl von "Quadratisch (2)" (im zweiten Menue)
  181.        2. Eingabe von "1"    fuer "f"
  182.        3. Eingabe von "4"    fuer "d"
  183.        4. Eingabe von "0"    fuer "e"
  184.        5. Eingabe von "1000" fuer "Schritte"
  185.        6. Eingabe von "0.1"  fuer "Schrittgroesse"
  186.        7. Eingabe von "-15"  fuer "Anfangswert"
  187.  
  188.     Es wird eine nach oben geoeffnete Normalparabel gezeichnet.
  189.  
  190. =============================================================================
  191. = HINWEIS ZUR DARSTELLUNG DER FUNKTIONEN :                                  =
  192. =============================================================================
  193.  
  194.     Eine Markierung auf der X- bzw. Y-Achse steht immer fuer jeweils einen
  195.     Schritt von "1". Die Abstaende der Markierungen sind veraenderbar.
  196.     Dadurch sind Manipulationen der Darstellung moeglich (Streckungen und
  197.     Stauchungen in X- und/oder in Y-Richtung).
  198.     Eine Veraenderung des "Wertes" einer Markierung ist (noch) nicht moeglich. 
  199.  
  200. =============================================================================
  201. = TIP(S) :                                                                  =
  202. =============================================================================
  203.  
  204.    - Hardcopies muessten mit dem Programm "GraphicDump" von der
  205.      WB V1.2 bzw. V1.3 bei geschicktem Einsatz moeglich sein.
  206.      Wer einen Freezer oder etwas Aehnliches besitzt, kann es auch damit
  207.      probieren. Es ist auch moeglich, den Bildschrim als IFF-ILBM-File zu
  208.      speichern und dann dieses mit einem anderen Programm zu laden und aus-
  209.      zudrucken (z.B. mit einem Zeichenprogramm).
  210.    - Falls Sie sich fuer DRAFU eine eigene Arbeitsdiskette erstellen sollten,
  211.      was sehr zu empfehlen ist, so achten Sie bitte darauf, dass Sie per
  212.      "Startup-Sequence" die logischen Devices "CLIPS:", "ENV:" und "T:" in
  213.      der RAM-Disk ("RAM:"/"RAD:") einrichten !
  214.      Eine spaetere Version von DRAFU wird moeglicherweise darauf zurueck-
  215.      greifen (sie ersparen sich also dann spaeter umstaendliche Anpassungen).
  216.  
  217. =============================================================================
  218. = VERSIONS-"HISTORY" :                                                      =
  219. =============================================================================
  220.  
  221.   V1.0 :
  222.  
  223.    - erste Version (ohne FLOAT-Unterstuetzung)
  224.  
  225. ------------------------------------------------------------------------------
  226.  
  227.   V1.5 :
  228.  
  229.    - jetzt mit FLOAT-Unterstuetzung (!)
  230.    - Fehlerkorrekturen in der Darstellung der Fuktionen, sodass die restlichen
  231.      Teile von teilweise nicht darstellbaren Funktionen (Screen zu klein)
  232.      korrekt dargestellt werden
  233.    - kleinere Verbesserungen in der Programmstruktur
  234.  
  235. ------------------------------------------------------------------------------
  236.  
  237.   V2.00 :
  238.  
  239.    komplette Ueberarbeitung des Programmes :
  240.  
  241.    - eigener Screen/eigenes Window waehrend der ganzen Laufzeit des Programmes
  242.    - ECHTE Menue-Steuerung
  243.    - Werteeingabe durch String-Gadgets
  244.    - dargestellte Funktion bleibt dargestellt (leichtere Hardcopies, s.o.)
  245.    - Farbmanipulationen sofort sichtbar
  246.    - Verwendung der "ak.library" V33
  247.    - u.v.m.
  248.  
  249. ------------------------------------------------------------------------------
  250.  
  251.   V2.01 :
  252.  
  253.    - Anpassung an "ak.library" V34, dadurch enorme Code-Verkuerzung
  254.  
  255. ------------------------------------------------------------------------------
  256.  
  257.   V2.02c :
  258.  
  259.    - jetzt Screen mit 16 Farben (4 BitPlanes)
  260.    - voreingestellte Farben (keine WB-Farben mehr)
  261.    - Hintergrund-/Vordergrund- und Darstellungsfarbe frei aus der Palette von
  262.      16 Farben waehlbar
  263.    - relative Codeverkuerzung
  264.    - Anpassung an "ak_gen0.library" V34
  265.      (Die "ak_gen0.library" ist die Nachfolge-Library der "ak.library".
  266.       Sie ist sowohl besser als auch kuerzer.)
  267.    - schnellere Berechnung der Funktionswerte
  268.    - Berechnung mit doppelter Genauigkeit
  269.    - Nutzung der Mathematik-Libraries der Workbench V1.3
  270.    - Jetzt Speichern des Bildschirmes als IFF-ILBM-File moeglich !!!
  271.      (640/256/4 (16 Farben) + CCRT-, CAMG-Chunk)
  272.    - komfortablere Eingabe der Parameter in den Masken
  273.      (groessere, uebersichtlichere Gadgets ;
  274.       automatische Aktivierung des naechsten Gadgets)
  275.  
  276.  
  277. ------------------------------------------------------------------------------
  278. ------------------------------------------------------------------------------
  279.  
  280.    Bekannte Fehler :
  281.  
  282.    - Speicher wird nicht vollstaendig wieder freigegeben
  283.      (wird demnaechst korrigiert)
  284.  
  285. ------------------------------------------------------------------------------
  286. ------------------------------------------------------------------------------
  287.  
  288.    Moegliche weitere Verbesserungen in spaeteren Versionen :
  289.  
  290.   - Abspeichern des Bildschirmes auch als IFF-ACBM-File
  291.     (spezielle IFF-BitMap fuer BASIC)
  292.   - Mehrere Funktionen gleichzeitig darstellen
  293.   - Speichern der Funktionsdaten
  294.   - Erweiterung und Verbesserung der Sonderfunktionen
  295.   - u.a.
  296.   - Fehlerverbesserung
  297.  
  298.   Ich bitte ausdruecklich um die Zusendung von BUG-Reports !!!
  299.  
  300. =============================================================================
  301. = INFORMATIONEN ZUR 'ak_gen0.library' :                                          =
  302. =============================================================================
  303.  
  304.     Die mit diesem Programm zu verwendende "ak_gen0.library" besitzt eine ei-
  305.     gene Dokumentation. Bitte aufmerksam durchlesen !
  306.     Danke !
  307.  
  308. =============================================================================
  309. = P.S. :                                                                    =
  310. =============================================================================
  311.  
  312.     Selbstverstaendlich weiss ich, dass DRAFU in seinem Metier nicht so gut
  313.     ist, wie gewisse andere, kommerzielle Programme zu Preisen zwischen
  314.     ca. 40 DM und ca. 70 DM. Dafuer ist DRAFU SHAREWARE, und niemand, der
  315.     nicht wirklich will, muss etwas dafuer bezahlen.
  316.     Das sollte bei aller, zugegebenermassen teilweise gerechtfertigten, Kritik
  317.     an den Leistungen von DRAFU nicht vergessen werden.
  318.     Im uebrigen werden die, die bereits die aelteste Version von DRAFU be-
  319.     besassen (falls es diese Gruppe von Personen gibt) die bereits vorgenom-
  320.     menen Verbesserungen sicherlich zu schaetzen wissen (welches kommerzielle
  321.     Programm der mittleren Preisklasse wird schon REGELMAESSIG verbessert ?).
  322.  
  323.     Es darf allerdings nicht verschwiegen werden, dass es gut moeglich ist,
  324.     dass ich mich irgendwann einmal dazu entschliessen koennte, DRAFU kommer-
  325.     ziell zu vertreiben.
  326.  
  327. =============================================================================
  328. = COPYRIGHTS :                                                              =
  329. =============================================================================
  330.  
  331. =============================================================================
  332. =   "DRAFU"                                                                 =
  333. =   (c) 1990-91 by Andreas R. Kleinert.                                     =
  334. =   SHAREWARE. All rights reserved.                                         =
  335. =============================================================================
  336. =   "ak_gen0.library"                                                       =
  337. =   (c) 1991 by Andreas R. Kleinert.                                        =
  338. =   FREEWARE. All rights reserved.                                          =
  339. =============================================================================
  340. =   Copyrights zu anderen erwaehnten Produkten/Programmen sind den jeweili- =
  341. =   gen Produktbeschreibungen der Hersteller/Verteiber zu entnehmen.        =
  342. =============================================================================
  343.